Beschreibung der allgemeinen Optionen
Dieses Modul ist erst in Versionen nach 20260507 verfügbar.
Mehrere ui_element-Schnittstellen akzeptieren eine Optionstabelle, um Ziel-App, Rückgabemenge, Rekursionstiefe, Trefferprüfung und Scrollschritte festzulegen.
Abfrageoptionen
local options = {
pid = app.front_pid(),
max_level = 2,
max_elements = 200,
include_hit_state = true,
}
- pid
Ganzzahl; Prozessbezeichner der Ziel-App. Wenn nicht übergeben, wird normalerweise die App im Vordergrund verwendet. - max_level
Ganzzahl; Rekursionstiefe der untergeordneten Elemente. Häufig steuern1oder2die Datenmenge. - max_elements
Ganzzahl; maximale Anzahl zurückgegebener Elemente der obersten Ebene. - fallback_children
Boolescher Wert; versucht, untergeordnete Elemente zu lesen, wenn die normale Liste leer ist. Der Standardwert hängt von der Schnittstelle ab. - include_hit_state
Boolescher Wert; gibt an, ob Trefferstatusfelder ergänzt werden. - hit_test
Boolescher Wert; gibt an, ob Treffer durch Bildschirmabtastung aktiviert wird. Für gewöhnliche Skripte normalerweise nicht erforderlich. - fallback_hit_test
Boolescher Wert; gibt an, ob bei einer leeren normalen Liste Treffer durch Bildschirmabtastung versucht werden. - hit_test_spacing
Zahlenwert; Abstand der Bildschirmabtastung in logischen Koordinaten. Standardwert40.
Optionen zum Ausschließen von Attributen
Ab Version 20261115 verfügbar. Nur für snapshot() und list_text_elements(). Alle sind boolesch, haben den Standardwert false und gelten auch für untergeordnete Elemente. Wenn diese Zustände nicht benötigt werden, können die Ausschlussoptionen den Abfrageaufwand verringern und die Snapshot-Erfassung beschleunigen.
- exclude_visibility
Beitruewerden Sichtbarkeitsabfragen übersprungen undisVisiblewird weggelassen. - exclude_map
Beitruewird die Prüfung des Kartenattributs übersprungen undisMapwird weggelassen; Kartenelemente bleiben erhalten. - exclude_hit_state
Beitruewerden Trefferprüfungen am Mittelpunkt übersprungen undcanHit,hitVerified,hitTestPointsowiehitTestPointLogicalwerden weggelassen. Nicht mitinclude_hit_state = truekombinierbar.
Der Umfang der Elemente, Text, Koordinaten und die Regeln zur ergänzenden Elementsuche durch hit_test / fallback_hit_test bleiben unverändert. Schließen Sie ein Zustandsfeld nicht aus, wenn Sie danach filtern möchten.
Aktionsoptionen
- point
Tabellenwert; Koordinatenpunkt für Scrollen oder Trefferprüfung, z. B.{ x = 200, y = 700 }, in physischen Pixeln. - x / y
Ganzzahl; gleichbedeutend mitpoint, kann direkt in der Optionstabelle stehen. - steps
Zahlenwert; Schrittparameter für Scroll-, Erhöhungs- oder Verringerungsoperationen. Die konkrete Wirkung hängt vom Zielsteuerelement ab.
Hinweise
list_text_elements()ist zur Kompatibilität mit älteren Skripten standardmäßig vorsichtiger.find(),find_all(),snapshot()und Aktionsschnittstellen eignen sich besser für die direkte Verwendung in neuen Skripten.hit_testkann ein Element liefern, das näher an der aktuellen obersten Oberfläche liegt, verursacht aber höhere Kosten und sollte nur verwendet werden, wenn eine normale Abfrage kein Element findet.